home *** CD-ROM | disk | FTP | other *** search
/ Gamers Delight 2 / Gamers Delight 2.iso / Aminet / game / role / eb.lha / ebdir / EB.doc < prev    next >
Text File  |  1994-09-27  |  7KB  |  164 lines
  1.  
  2. ElectriBones Documentation
  3.  
  4.               ElectriBones v2.7 - Electronic Dice Program
  5.               © 1994 BlackLight Software - Erskin Cherry
  6.  
  7.                           Legal Stuff      
  8.                           What is it?      
  9.                           How do I use it? 
  10.                           What about WB?   
  11.                           Known bugs!?!?!  
  12.                           History          
  13.  
  14. EB -=- ElectriBones v2.7 -=- © 1994 BlackLight Software -=- Erskin Cherrry
  15.  
  16. What you can get away with.
  17.  
  18.     EB, and its source is copyrighted to BlackLight Software and
  19.     Erskin Cherry. You may NOT charge any fee for it, save a nomial one for
  20.     shipping costs. (no more than $1 US) You may freely distribute EB and
  21.     its source, learn from it, and enjoy it. You may not use it in any part
  22.     of a commercial program without written consent form the author. You
  23.     may use it in any program for no fee if the program it is used in is
  24.     itself free. All rights not listed here are reserved.
  25.  
  26. What it is.
  27.  
  28.     A simple program to allow your computer to generate multiple mutli-
  29.     sided dice rolls from the CLI or WB.
  30.  
  31. What to do from the CLI.
  32.  
  33.     You can call it from the CLI with the format:
  34.  
  35.         EB <number>d<die>+/-<modifier>
  36.     (I know that isn't standard format, please forgive me.)
  37.  
  38.     Example 1 - to roll and total up three six sided dice:
  39.  
  40.         eb 3d6
  41.  
  42.     Example 2 - to roll a twenty sided die with a plus 4 modifier:
  43.  
  44.         eb 1d20+4
  45.  
  46.     Example 3 - to roll a 100 sided die (percentage) minus 30 percent:
  47.  
  48.         eb 1d%-30       or        eb 1d100-30
  49.  
  50.     See, easy as pie! You'll notice that the program returns just the
  51.     number followed by a return. This is so you can use it's output in
  52.     other programs directly, rather than adding code to pull out the
  53.     number.
  54.  
  55. What all the little buttons do.
  56.  
  57.     You can also run the program from workbench. I advise this method if
  58.     you plan on generating more than one or two rolls. The initialization
  59.     code will only be executed once, and I'd be real disapointed if you
  60.     never looked at all the codeing I put into the window! ;>
  61.  
  62.     The display should open up something like this:
  63.         __________________________
  64.         [*]____Electribones____[+]    The close and front to back gadgets
  65.         |                        |    should need no explaination.
  66.         | N [ 1][ 2]  [ 2][ 4] D |
  67.         | u [ 3][ 4]  [ 6][ 8] i |    The number buttons on the left by
  68.         | m [ 5][ 6]  [10][12] c |    the word "number" allow you to pick
  69.         | b [ 7][ 8]  [20][ %] e |    how many 'dice' you want rolled.
  70.         | e [ 9][10]  [ Roll ]   |
  71.         | r ___________________  |    The number buttons on the right by
  72.         |   | ###   ###   ### |  |    the word "dice" allow you to pick
  73.         |   |#   # #   # #   #|  |    how many sides are on the virtual
  74.         |   |#   # #   # #   #|  |    dice.
  75.         |   | ###   ###   ### |  |
  76.         |   |#   # #   # #   #|  |    The roll button below the left side
  77.         |   |#   # #   # #   #|  |    number buttons will 'roll' and total
  78.         |   |_###___###___###_|  |    the dice and display the result on
  79.         |                        |    the large leds that take up the
  80.         |    © 1994 BlackLight   |    lower half of the window.
  81.         |      v2.4  Software    |
  82.         |________________________|    The other text is for your reference.
  83.  
  84. Know your local bugs!
  85.  
  86.     None so far! I finally fixed up the random number initialization
  87.     thanks to the Cheese Olfactory Workshop! All I really need to od now
  88.     is fix it to use a SIMPLE_REFRESH.
  89.  
  90.                         How did you write this? 
  91.  
  92. Do you really want to know?
  93.  
  94.     I'm glad you asked! I wrote this program with less effort than you
  95.     might think using that new and powerful language by Wouter van
  96.     Oortmerssen called E! With the incredible power of version 2.1b, this
  97.     program was a snap! (well not really, but this is an ad, so I had to
  98.     say something!) The blazing powerful compiler-linker turned my E source
  99.     into a tiny, solid power packed executable in a matter of milliseconds!
  100.     If you haven't seen E yet, then you're behind! The power of the Amiga
  101.     is at ypour fingertips with E!
  102.  
  103.                         Where can I get this? 
  104.  
  105. Where else but the InterNet!
  106.  
  107.  
  108. To get your own copy of E, (version 3.0b is well worth the $40!) simply
  109. contact you local InterNet NODE and ftp to any site carring AmiNet! E can
  110. be found at wuarchive.wustl.edu and ftp.luth.se, just to name two, in the
  111. /pub/amiga/dev/e directory! If you can't get ot the InterNet, find someone
  112. who can or check out your local BBS's for this powerful, clean-cut, and
  113. smooth programming language!
  114.  
  115.     If you are still reading so you can figure out how to send me money,
  116.     well, I won't be so mean as to not tell you. I can be reached at:
  117.  
  118.     echerry@owl.warren-wilson.edu -=- InterNet Email
  119.  
  120.     Erskin Cherry
  121.     WWC#5402                      -=- Snail Mail
  122.     P.O. Box 9000
  123.     Asheville, NC 28815-9000
  124.  
  125. It just keeps geting longer!
  126.  
  127.     Still reading? Wow, you must be bored, persistant, or a programmer who
  128.     wants to laugh at my code! Well, here goes, for what it's worth!
  129.  
  130. v0.5 -=- Not released
  131.     Die roller and input converter built. Written in C.
  132.  
  133. v1.0 -=- Cli Version -=- Released to local friends and BBS's -=- 9/93
  134.     Full cli input accepted and parsed with modifiers, random number
  135.     initialization code worked poorly and did not provide anything
  136.     resembling random numbers. Still in C.
  137.  
  138. v1.5 -=- Not Released
  139.     Graphical interface designed and implemented using a nice IFF and what
  140.     I learned was an obselet gadget field called mutal exclude. Still C.
  141.  
  142. v2.0 -=- Not Released
  143.     Cli version totally rewriten in E. Executable size dropped 200%.
  144.  
  145. v2.4 -=- Full Version -=- Released to InterNet -=- 5/94
  146.     Fully rewritten in E. Worked around the need for the mutual exclude
  147.     by going from toggle to momentary gadgets. Made simple graphics by
  148.     using built-in gagdget calls and drawing a few lines. Not able to
  149.     properly hand a SIMPLE_REFRESH, although the redrawing code is in place.
  150.     SMART_REFRESH used for now. Initialization code dramatically improved.
  151.     Produces decent one time random numbers from cli and decent multiple
  152.     random numbers from GUI. Multiple cli calls result in a biased roll.
  153.  
  154. v2.7 -=- Update One -=- Released to InterNet -=- 9/94
  155.     Decided that if you ran the program, you probable wanted the window
  156.     to be active, so I might as well set the flag and do it for you.
  157.     Incorparated two wonderful modules provided by the Cheese Olfactory
  158.     Workshop.  (StrErr.m and StayRandom.m)  StrErr.m allows sensible and
  159.     intelligent redirectable and non-redirectable error output.  Not that
  160.     EB has tons of error messages, but this thing is just too cool not to
  161.     use.  StayRandom does just that; makes the darn Rnd() function STAY
  162.     random!  CLI calls now produce decent pseudo-random numbers and the
  163.     GUI's are practically flawless.
  164.